home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / comm / misc / GigaGuide.readme < prev    next >
Encoding:
Text File  |  1998-03-08  |  12.2 KB  |  428 lines
  1. Short:    Makes guide of aminet files etc. v1.8
  2. Author:   fini.alring@netmedia.dk (Fini 'Warp' Alring)
  3. Uploader: fini.alring@netmedia.dk
  4. Version:  1.8
  5. Type:     comm/misc
  6. Requires: Arexx, rexxsupport.library, aminet:util/sys/DirII.lha (v3.3a).
  7.  
  8. Long:
  9.  
  10.  
  11.                   Fini "Warp" Alring of GiGA Productions.
  12.  
  13.  
  14.                                  Presents
  15.  
  16.  
  17.                        ·GigaGuide (ex. AmiNetGuide)·
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24. *************** This program requires this cool Dir replacement: ***************
  25.  
  26.  
  27.              It can be found on Aminet:pub/util/sys/DirII.lha
  28.  
  29.  
  30. ********************************************************************************
  31.  
  32.  
  33. ******************************* NOTE about GIF support: ************************
  34.  
  35.   Even though I don't like this format, we have to trouble ourselves, for some time.
  36.   Since GIF is used widely on the net.  I suggest you only use PNG & JPEG etc.
  37.   
  38.   
  39.   
  40.   See more info about the Portable Network Graphics format (PNG) at this URL:
  41.   
  42.          W3C - World Wide Web Consortium. >> http://www.W3C.org <<
  43.  
  44. ********************************************************************************
  45.  
  46.  
  47.  
  48.  I made it because my new dowload dir, is approx. 80MB, and I simply can't cope with it!
  49.  
  50.  Dopus just isn't enough... ;-)
  51.  
  52.  
  53.  GigaGuide scans the first line of all readme files in a given dir,
  54.  
  55.  where the Short: description is located (Look at the first line of this text!!!)
  56.  
  57.  It then generates an AmigaGuide, with links to both readme and it's main file.
  58.  
  59.  It can also be used to make a guide of your pictures dir, or archives dir etc...
  60.  
  61.  When you click on the filename gadget, 
  62.  the archive will be decompressed into Ram:, or anywhere you desire 
  63.  (you can also choose by file requester).
  64.  
  65.  Pictures and Samples can be viewed/played by a siple click, 
  66.  using you preferable viewer/player.
  67.  
  68.  When you click on the Short: text, the whole readme file will be shown.
  69.  
  70.  Sub-Dirs are shown as gadgets, and by a click, 
  71.  you can generate a Guide for that directory too.
  72.  
  73.  It can put the Short:-line into the archive's filenote (comment),
  74.  which is very useful, especially for BBS ownerS! ;-)
  75.  
  76.  It can sort files in 'Alphabetical order' or 'Newest at top order'.
  77.  
  78.  
  79.                             ******************
  80.                             ******************
  81.  
  82.                                GOOD NEWS!!!
  83.  
  84.                             ******************
  85.                             ******************
  86.  
  87.  
  88. If you own LZX v1.10r (the registered version of 1.10) and up,
  89. then you can use LZX to decompress LHA & LZH archives, thus
  90. increasing performance by 25-35% (Acording to LZX.Guide). 
  91.  
  92. Mr. Jonathan Forbes has quit his work on LZX, at least on the Amiga Platform.
  93. A little while ago, some people from the Amiga community, asked Mr. Forbes to
  94. release a generic keyfile for LZX v1.21r (The newest! ever to be made ;-( )
  95. and Mr. Forbes graciously agreed... And now we have the product as FREEWARE (Not PD!) 
  96.  
  97.  
  98. Rumour: I (Warp) heard from somewhere that LZX algorithms where sold to the devil 
  99.         himself; Bill Gates! And that M$'s CAB format is really LZX in a new form.
  100.         (Windows95 is compressed in CAB format on the CD-ROM it's shipped on).        
  101.         Please note: I can't validate this story. But I believe it... ;-)
  102.  
  103.  
  104.                             *******************
  105.                             *******************
  106.  
  107.  
  108.                                  History: 
  109.  
  110.                   (This will be moved to a Guide soon! =)
  111.  
  112.  Names bounded with brakets ( [Fini Alring] ) is the names of persons 
  113.  who gave me the idea, of the certain feature... thanks guys!!! =)
  114.  
  115.  
  116.  
  117.     SHORT = Short message about the release.
  118.     FIXED = Fixed
  119.     ADDED = New
  120.     REMOV = Removed
  121.     REWRI = Rewritten
  122.     OVERW = Overworked
  123.     IMPRO = Improved
  124.     REPLA = Replaced
  125.     RENAM = Renamed
  126.  
  127.  
  128.  
  129.  
  130. Future:
  131.  
  132. M2M Gadget - Move to (Local Aminet) Mirror, this is being developed,
  133.              and works fine, but I want to do it properly for aminet release.
  134.  
  135.  
  136.  
  137. ----
  138.  
  139.  New in v1.8 - 04.Feb.1998
  140.  
  141.  Short: More to come... Just had to make these changes. ;-) 
  142.         Preparing complete re-code, for version 2.0 - You want a MUI GUI?. 
  143.         26 Jan - I downloaded an imitation of GigaGuide! ;-D phew! sucked! ;)
  144.  
  145.  · ADDED  <ED> Gadget - Same as "C:ED dh0:download/SomeFile.ReadMe". 
  146.                         Note: You have to regenerate the guide, to see the changes. 
  147.                         Also remember to write Short: on the first line. blah!
  148.  
  149.  · ADDED  .bat suffix, for AmigaDOS batch-scripts. = "C:Execute MyScript.Bat >CON:"
  150.           - Tell me, if you have an idea how to make this better...
  151.  
  152.  · ADDED  Option -LZX = Use LZX v1.10r+ to decompress LHA/LZH archives 25-35% faster!!!
  153.           (Read the good news part elsewhere in this document).
  154.  
  155.  · FIXED  When -NS is enabled all text files opens on current screen.
  156.           [Jonah Hex] - Complaining does work! eh?!
  157.  
  158.  · ADDED  Proper $VER: implementation. (Try C:Version C:GigaGuide in shell).
  159.           [Jonah Hex] - Gotta do this with all my progs, i guess.. ;-)
  160.  
  161.  · RENAM  'Delete' gadget in AmigaGuides®'s are now called 'Del', shorter!
  162.  
  163.  · IMPRO  Guide text was moved many chars to the left, that has been altered,
  164.           to give more room for extra gadgets (eg. 'Ed' & 'Del', 'M2M').
  165.  
  166. ----
  167.  
  168.  New in v1.7 - 25.Nov.1997
  169.  
  170.  Short: At last another Aminet release. I'm planning a v2.0 w/GUI (And CLI!) etc...
  171.  
  172.  · IMPRO  C:Lha is copied to Ram:, when -X option, is enabled. Faster!
  173.  
  174.  · IMPRO  GG now also support readme files with the '.REA' suffix, for people who
  175.           download stuff on a M$-PC! - [Thanks Guido! ;-]
  176.  
  177. ----
  178.  
  179.  New in v1.7ß - 19.Oct.1997 - Only for beta testers.
  180.  
  181.  Short: Sorry for delay, but I wanted this version to include a lot of things. 
  182.  
  183.  · ADDED  Option -NL = Don't make linespaces in the guide. [Jannik Rasmussen!]
  184.  
  185.  · ADDED  Option -X  = Attempt to extract missing/corrupt readme's from archives (lha only)
  186.  
  187.  · ADDED  Option -GD = Set Guide Destination, for CD-ROM's etc.. (-GD Ram:)
  188.           [Joel Dulon! - Sorry you had to wait sooo long!]
  189.  
  190.  · ADDED  Text file suffixes: .text .doc .dok
  191.  
  192.  · ADDED  .exe suffix supported, file is launched.
  193.  
  194.  
  195.  
  196.  
  197. ----
  198.  
  199.  New in v1.6 - 07-Jul-1997
  200.  
  201.  Short: AminetGuide has changed name to GigaGuide. Enjoy this cool version!
  202.  
  203.  · FIXED  Download dir path, can have spaces in it. 
  204.           In v1.4 only my argument handler supported it. 
  205.           
  206.  · IMPRO  Usage text, Delete gadget and other cosmetics. 
  207.  
  208.  · FIXED  The -Aminet.guide will not be shown it it's own list.
  209.  
  210.  · ADDED  AminetGuide now requires DirII v3.3a+ by Stephen Davies ©1995
  211.  
  212.  · ADDED  Option: -SM. CASE = Alpha order.  DATE = Newest files at the top.
  213.  
  214.  · ADDED  Filedates are written in the -Aminet.guide.
  215.  
  216.  · ADDED  Option: -N = Set the min. length of filename gadgets. ( -N 18 )
  217.  
  218.  · ADDED  Option: -U REQ = Brings up a dir-requester, so you can choose where to unpack!
  219.           Note:   If you hit cancel, it will unpack to the dir, where the guide is.
  220.  
  221.  · ADDED  Option: -NS = No screen, guides will open on workbench screen. 
  222.  
  223.  · ADDED  Option: -SP = Sound Sample player. (-SP C:Play16) 
  224.  
  225.  · ADDED  ZIP support, using C:Unzip.
  226.  
  227.  · ADDED  PNG picture support. 
  228.  
  229.  · ADDED  IFF picture support. 
  230.  
  231.  · ADDED  HAM picture support. 
  232.  
  233.  · ADDED  HAM8 picture support. 
  234.  
  235.  · ADDED  ILBM picture support. 
  236.  
  237.  · ADDED  FILE_ID.DIZ support using multiview. 
  238.  
  239.  · ADDED  8SVX sound sample support.
  240.  
  241.  · ADDED  WAV sound sample support.
  242.  
  243.  · ADDED  SND sound sample support.
  244.  
  245.  · ADDED  Old -Aminet.guide's will be deleted automatically.
  246.           (This will be done, in the next couple of versions).
  247.  
  248.  · MODIF  Because of the new name created guides, will be called -GiGA.guide instead.
  249.  
  250.  · IMPRO  Info content now shows all options, and supported suffixes, and more.
  251.  
  252. ----
  253.  
  254.  New in v1.5 - 25-Jun-1997 
  255.  
  256.  Short: Can now unpack/view files, which doesn't have a readme file.
  257.  
  258.  · IMPRO  AmiNetGuide can see all files, even if they don't have a readme file.
  259.  
  260.  · IMPRO  This history text, now uses MCP's history format.
  261.  
  262.  · FIXED  Guide "hanged" when opening a Sub-Dir guide.
  263.  
  264.  · FIXED  Sub-Dir guides did not use the options set by user.
  265.  
  266.  · FIXED  Multithreading now works 100% :). 
  267.  
  268.  · ADDED  AmigaGuide® support using MultiView (or other clone).
  269.  
  270.  · ADDED  NFO support (Text files) using MultiView (or other clone).
  271.  
  272.  · ADDED  DMS support, unpacks DMS files (defaults to RAD:).
  273.  
  274.  · ADDED  Option: -D = Set DMS unpack destination. ( -D RAD: )
  275.  
  276.  · ADDED  Ignores .info files (Icons). 
  277.  
  278.  · ADDED  Readme files also gets the short: message attached, in -C mode.
  279.  
  280. ----
  281.  
  282.  New in v1.4f - Fixed a bug, no default value for short length... 
  283.                 ups! why does it always happen!!
  284. ----
  285.  
  286.  New in v1.4 (Huge update!!!) 13 Jun 1997.
  287.  
  288.  
  289.  
  290.  · Made a very good argument parsing, which also alows to use spaces in in args, 
  291.    eg. "Dh1:Down load"  <- Just put double quote on both sides. 
  292.  
  293.  · Added Seven (Yup 7! ;) options, of which many have been requested by users. 
  294.  
  295.  Usage:
  296.  
  297.      AminetGuide <Download dir> [Options]
  298.  
  299.  Options:
  300.  
  301.  -F = Sets Guide font.  ( -F Topaz.font 8 )
  302.  
  303.  -V = Path to MultiView. ( -V C:Multiview )
  304.  
  305.  -U = Set unpack dir. ( -U Dh1:Download/Unpacked/ )
  306.  
  307.  -S = Set the length of Short: notes. ( -S 55 )
  308.  
  309.  -C = Add Short: into filecomment, of the archieve.
  310.  
  311.  -G = Don't make Guide, use if only filecomments are wanted.
  312.  
  313.  -P = Path to image viewer. ( -P C:PPshow )
  314.  
  315.  · Option characters are non-case dependant ( -c = -C ).
  316.  
  317.  · Options can be put in any order, but all it's arguments must be entered.
  318.  
  319. ----
  320.  
  321.  New in v1.3 - (Ups! Pic bug!) 09 Jun 1997
  322.  
  323.  · Pictures couldn't be viewed. - Sorry! Won't happen again! ;-D
  324.  
  325.  · Added LZH support. - Unpacks using LHA.
  326.  
  327.  · Added TXT support. - Using Multiview. - [Per Gustav Ousdal]
  328.  
  329.  · Short: message is now 55 chars long. - Legal Short:'s should only be 40 chars,
  330.    but many people don't respect this. Tell me what length you want! Maybe argument?
  331.  
  332. ----
  333.  
  334.  New in v1.2 (Bugfixed v1.1) 08 Jun 1997
  335.  
  336.  · Sorry guys!! I didn't test v1.1 good enough, it couldn't unpack lha... 
  337.    This is fixed...  Once again, I'm very sorry!
  338.  
  339.  · Download paths can be bounded with double quotes eg. "dh1:download/"
  340.    This is needed for Dopus v5.5 (and Magellan). (  C:AminetGuide {s}  )
  341.  
  342.  · GIF is now supported, some guy asked for it, and it was soo easy to support!
  343.    Even though I don't like this format, we have to trouble ourselves, for some time...
  344.    Since GIF is used widely on the net.  I suggest you only use PNG & JPEG.
  345.  
  346. -----
  347.  
  348.  New in v1.1 (Added lots of new things.)
  349.  
  350.  · Proper Alpha sorting. - [Per Gustav Ousdal]
  351.  
  352.  · LZX support - Now also unpack lzx archives.
  353.  
  354.  · Added gadget "Delete" - Deletes archive, and readme file.
  355.  
  356.  · Readme files are now opened on their own screen.
  357.  
  358.  · JPG and JPEG are now supported, requires PPshow.
  359.  
  360.  · Sub directories are detected, gadgets at the bottom!! - [Martin Lundqvist]
  361.  
  362.  
  363.  Note: AminetGuide must be in C: to make Sub-dirs work..!
  364.  
  365.  
  366. --------------------------------------------------------------------
  367.  
  368.  
  369.  Usage: GigaGuide <Download dir> [Options]
  370.  
  371.  
  372.  Other features:
  373.      
  374.      · It's MailWare - I only want your own productions, and a little letter...! 
  375.      
  376.      · It multithreads, so you can unpack many files at ones, 
  377.       and have multiple readme windows opened at the same time...
  378.  
  379.      · The -GiGA.guide will be placed in the download directory...
  380.  
  381.  
  382.  
  383.  
  384. Future: 
  385.  
  386.     · Type sorting.
  387.     
  388.     · Support of more pictures and Archives.
  389.     
  390.     · Maybe support for FILEID.DIZ extraction.
  391.     
  392.     · Which picture viewer should be default?? 
  393.     
  394.     · write me!! 8)
  395.  
  396.  
  397.  
  398. *** NOTE:  To get more help, start the program without arguments ***
  399.  
  400.  
  401.  
  402. Author: fini.alring@netmedia.dk (Fini 'Warp' Alring)
  403.  
  404. IRC:  Sunsite.auc.dk or irc.FUnet.fi  Channel: #AmigaDK
  405.  
  406.  
  407. NOTE to bug reporters:  
  408.  
  409.  Please tell me what version you are using, since I make updates frequently.  
  410.  
  411.  
  412.                  
  413.                       Only Amiga makes it possible!!!
  414.  
  415.  
  416. ============================= Archive contents =============================
  417.  
  418. Original  Packed Ratio    Date     Time    Name
  419. -------- ------- ----- --------- --------  -------------
  420.      687     687  0.0% 04-Feb-98 23:11:52 +GigaCLS.lha
  421.      858     491 42.7% 04-Feb-98 23:10:30 +GigaCLS.readme
  422.    13959   13959  0.0% 03-Jul-97 00:41:00 +DirII.lha
  423.      610     415 31.9% 03-Jul-97 00:41:08 +DirII.readme
  424.    16048    5398 66.3% 04-Feb-98 23:28:12  GigaGuide
  425.    11898    5156 56.6% 04-Feb-98 21:41:00  GigaGuide.readme
  426. -------- ------- ----- --------- --------
  427.    44060   26106 40.7% 05-Feb-98 06:03:10   6 files
  428.